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SECTION I 
GENERAL INFORMATION 



1-1. GENERAL DESCRIPTION 

1-2. This manual contains information and procedures that allow the user to 
write application programs using FORTRAN or Assembly language and RTE Driver 
DVR11. Section III provides information required when configuring DVR11 into a 
Real-Time Executive (RTE) Operating System. 

1-3. The driver is entered through a FORTRAN or Assembly language call to con- 
trol an HP 2892A Card Reader (via a HP 12924A Card Reader Interface Kit) in a 
Real-Time Executive Operating System environment. The driver may be used for 
reading Hollerith data, packed binary data, or column binary image data into an 
area of memory (input buffer) designated by the user. The user initiates the 
reading of a card by executing a calling sequence. The driver can convert 
binary-coded-decimal (BCD) cards, standard HP EBCDIC (extended binary-coded- 
decimal interchange code) cards, and EBCDIC-RDTS (remote data transmission sys- 
tem) cards. If the card is read successfully, the driver returns control to the 
user's program. The user may request card reader status information and the most 
recent transmission count at any time by executing a special calling sequence. 

1-4. OPERATING ENVIRONMENT 

1-5. The operating environment for this software must be: 

a. HP 1000 Series Computer 

b. RTE Operating System 

c. HP 12924A Interface Kit 

Refer to the HP 12924A Operating and Service Manual (HP Part No. 12924-90001) 
for interface kit hardware details. 

1-6. COMPONENTS 



1-7. The following components are included with Driver DVR11: 

a. This manual 

b. Driver DVR11 binary tape, HP Part No. "29030-60001. 
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SECTION II 
APPLICATION INFORMATION 



2-1. GENERAL 

2-2. This section details the calls to the driver and describes any results 
of the hardware/ software marriage where the hardware may influence software 
techniques . 

2-3. CALLING SEQUENCES 



2-4. The HP 2892A Card Reader is operated in the Real-Time Executive Operating 
System through FORTRAN or Assembly language programs calling DVR11. These calls 
are listed in Tables 2-1 and 2-2 and described in Paragraphs 2-5 through 2-9. 

2-5. READ CALL 

2-6. This calling sequence (Table 2-1) reads one card through the specified 
card reader. If the read operation is performed satisfactorily, the driver re- 
turns control to the "return point". To read a deck of cards, it is necessary to 
execute the calling sequence repeatedly (once for each card). 

2-7. The maximum possible transmission count after any read operation is as 
follows: 

Hollerith: 80 characters of 40 words 
Packed Binary: 60 words 
Column Image Binary: 80 words 

2-8. The number of words or characters transferred during any read operation 
is as follows: 

Hollerith: Buffer length (IBUFL) or the number of charac- 
ters on the card (not including trailing blanks) , 
whichever is smaller. 

Packed Binary: Buffer length (IBUFL) or the count in rows 12-5 
of column 1 of the card, whichever is smaller. 

Column Image Buffer length (IBUFL) or the number of used 

Binary: columns on the card (not including trailing 
blanks), whichever is smaller. 

2-9. STATUS REQUEST 

2-10. This calling sequence (Table 2-2) causes two words in the Equipment Table 
(EQT) to be copied into the specified pair of memory locations (ISTA1 and (ISTA2) . 
After the information has been copied, control returns to the "return point". 
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Table 2-1. HP 2892A Read Calls (DVR11) 



Assembly 
Language 



EXT EXEC 



JSB EXEC 
DEF *+5 
DEF ICODE 
DEF ICNWD 
DEF IBUFR 
DEF IBUFL 
<return point > 



Where : 



ICODE = Function Code 

1 = Read Request 



ICNWD = Control 
Bits 
thru 5 



Word 



}■ 



Bits 6 
and 7 



Logical Unit Number. The card reader 

may be assigned up to three logical 

unit numbers : 

LU #N = reader, subchannel 

LU #M = reader, subchannel 1 

LU #L = reader, subchannel 2. 

a. To convert EBCDIC punch set, 
address reader as subchannel 0. 

b. To convert BCD punch set, address 
reader as subchannel 1 . 

c. To convert EBCDIC-RDTS punch set, 
address reader as subchannel 2. 

Type of data to be read 

or 



Bits 
thru 



8 ) = 
IS J 



2 = 

3 = 
1 = 

Not used 



Hollerith 
Packed Binary 
Column Binary Image 



IBUFR = Address of data storage buffer's first word for Read 
call . 

IBUFL = Size of input buffer. Size may be expressed either 
as a number of words or as a number of characters . 
The sign of IBUFL tells the driver how to interpret 
length specification as follows: 

+ = words 

- = characters 

a. If IBUFL is expressed as a number of words, 
transmission count placed in EQT by driver at 
end of Read operation is also expressed as num- 
ber of words. Likewise, if IBUFL is expressed 
as a number of characters, transmission count 
is expressed as a number of characters. 

b. An IBUFL should be expressed as a number of 
characters only when reading in Hollerith code. 

c. An IBUFL of zero in Hollerith code causes an 
immediate return to user's program (return point) 
with a transmission count of in EQT. 



FORTRAN 



CALL EXEC (ICODE, ICNWD, IBUFR, IBUFL) 
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Table 2-2. HP 2892A Status Call (DVR11) 



Assembly 






Language 








Where : 




EXT EXEC 


ICODE = Function Code 

13 - Status Request 




JSB EXEC 


ICNWD = Logical Unit Number 




DEF *+4 or [*+5] 






DEF ICODE 






DEF ICNWD 


ISTA1 = Card Reader status flags. See Table 


2-3 


[DEF STAT2] 


for format. 




<return point> 


ISTA2 = Most recent transmission count. May 


be 


• 


omitted from calling sequence. 




FORTRAN 


CALL EXEC [13,LU,ISTA1,ISTA2 (optional)] 





2-11. After a Status request, ISTA1 contains the card reads status flags and 
ISTA2 contains the most recent transmission count. The format of ISTA1 is de- 
scribed in Table 2-3. 



2-12. 



DATA FORMAT 



2-13. The driver accepts Hollerith data, packed binary data, or column binary 
image area. These modes are described in Paragraphs 2-14 through 2-22. 



2-14. 



HOLLERITH 



2-15. In the Hollerith mode, card codes are converted to ASCII octal equiva- 
lents and stored in the input buffer. Each word in the buffer accommodates two 
codes. The octal equivalent of a code from an odd-numbered card column is 
always stored in bits 8 through 15 of a buffer word while the octal equivalent 
of the code from the next highest even-numbered card column is stored in bits 
through 7 of the same word. Codes are stored in the input buffer consecutively 
starting with the first (lowest) buffer word. For example, the codes from card 
columns 1 and 2 are always stored in the first buffer word, the codes from card 
column 3 and 4 are always stored in the second buffer word, etc. Trailing 
blanks, though actually read into the buffer, are not included in the trans- 
mission count returned by the driver at the end of the read operation. 

2-16. The driver accepts all 64 standard Hollerith card codes. Table 2-4 
shows the octal equivalents for each code. Note that there are two octal equiva- 
lents for each code. The lesser value applies if the code is stored in bits 0-7 
of a word while the greater value applies if the code is stored in bits 8-15. 

2-17. All non-valid card codes enter the input buffer as the ASCII code for 
the question mark. 
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Table 2-3. Status Information (I STAT) 



Bits 


Function 


15-14 


Card Reader availability code 




= available 




1 = disabled (down) 




2 = currently busy 




3 = waiting for an available DMA channel 


13-8 


Equipment code 




always = 11 (octal) 


7-0 


Status flags. Meaning when on (1 = on, = off) 




Bit Status 




Card-reader is on-line but not ready or card reader is 




off-line. 




1 An illegal card code is encountered during previous read 




operation or card reader has hardware trouble. 




2 Card reader is off-line. 




3 Timing error or pick failure was sensed during previous 




read operation. 




4 Pick failure or card motion error was sensed during pre- 




vious read operation. 




5 If both bits 3 and 5 are on, no data was transmitted during 




previous read operation. If bit 3 is off and bit 5 is on, 




previous read request was rejected because hopper was empty 




or stacker was full. 




6 Stacker is full. 




7 Previous Read operation left input hopper empty and END OF 




FILE switch was on during Read operation. 




Codes 0, 2, 5, and 6 indicated that previous Read request was re- 




jected for specified reason. 



2-18. With the following six exceptions, every internal ASCII code relates 

directly to the corresponding key on an IBM 029 keyboard. Note that although 

the internal ASCII ! character corresponds with the IBM 029 key, the standard 
and RDTS ASCII octal equivalents are different. 



Internal 






ASCII Octal 


ASCII Octal 


ASCII 




Hollerith 


Equivalents 


Equivalents 


Character 


029 Key 
t 


Code 


(Standard) 
133 or 554 


(for RDTS) 


[ 


12-8-2 


Unassigned 


/ 


0-8-2 


0-8-2 


134 or 560 


134 or 560 


] 


- 


11-8-7 


135 or 564 


136 or 570 


+ 


1 


12-8-7 


136 or 570 


41 or 204 


■*- 




0-8-5 


137 or 574 


137 or574 


i 


1 


11-2-8 


41 or 204 


135 or 564 
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Table 2-4. EBCDIC Hollerith-to-ASCII Octal Equivalents 



Character 



EBCDIC 
HOLLERITH ASCII 



ASCII 

Octal Equivalent 



iBits 15-8 
(offset) 



Bits 7-0 
(true) 



A 
B 

C 
D 
E 
F 
G 
H 
1 
J 
K 
L 
M 
N 

P 

Q 

R 

S 
T 
U 
V 
W 
X 
Y 
Z 


1 
2 
3 
4 
5 



A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 

P 

Q 

R 

S 

T 
U 

V 

w 

X 
Y 

z 



1 

2 
3 
4 
5 



404 
410 
414 
420 
424 
430 
434 
440 
444 
450 
454 
460 
464 
470 
474 
500 
504 
510 
514 
520 
524 
S30 
534 
540 
544 
550 

300 
304 
310 
314 

320 
324 



101 
102 
103 
104 
105 
106 
107 
110 
111 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 

060 
Obi 
062 
065 
064 
065 



Character 




EBCDIC 
HOLLERITH 


ASCII 


6 


6 


7 


7 


8 


8 


9 


9 


(space) 

i 


i 


" (quote) 


ii 


» 


# 


$ 


$ 


% 


% 


<. 


6 


' (apostrophe) 


1 


( 


( 


) 


) 


* 


* 


+ 


+ 


, (comma) 


, 


- (hyphen or minus) - 


. (period) 




/ 


/ 
1 



ASCII 
Octal Equivalent 



Bits 15-8 Bits 7-0 
(offset) (true) 



* (cent) 
— I (not mark) 
| (vertical bar*) 
_ (underscore** ) 
0-8-2 

*NUHEFIC Y 
**NUMERIC W 



330 
334 
340 
344 

200 
204 
210 

214 
220 
224 
230 
234 
240 
244 
250 
254 
260 
264 
270 
274 
350 
354 
360 
364 
370 
374 
400 
554 
564 
570 
574 
560 



066 
067 
070 
071 

040 
041 
042 
043 
044 
045 
046 
047 
050 
051 
052 
053 
054 
055 
056 
057 
072 
073 
074 
075 
076 
077 
100 
133 
135 
136 
137 
134 
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2-19. PACKED BINARY 



2-20. In the packed binary mode, every four card columns are read into ("packed 
into") three buffer words. See Figure 2-1. The relocatable decks produced by 
assemblers and compilers are in packed binary format. A full 80-column packed 
binary card fills a 60-word input buffer. In rows 12-5 of the first column of 
each card is a three-digit octal number (row 12, high order bit), specifying how 
many words of data are on the card. The count includes itself, since it is read 
into the input buffer along with the other data. 

2-21. COLUMN BINARY IMAGE 

2-22. In the column binary image mode, the information in each card column is 
read into bits 0-11 of a separate buffer word (bits 12-15 are set to zeroes) . 
Refer to Figure 2-2. The columns are stored in the input buffer consecutively 
starting with the first (lowest) buffer word. For example, card colum 1 is 
always read into the first buffer word, card column 2 is always read into the 
second buffer word, etc. 

2-23. REJECTION OF A READ REQUEST 

2-24. Either of the following conditions causes a Read request to be rejected: 

a. The request code of other parameter is illegal. 

b. The specified card reader is not ready. 

When a Read request is rejected, the status information in the Equipment Table 
(EQT) is updated and control passes to the operating system (not to the user's 
program) . 

2-25. ERRORS 



2-26. If an error condition occurs during the reading of a card, the driver 
alters the appropriate entry in the equipment table (EQT) to signify that the 
card reader is "down" and then passes control to the operating system (not to 
the user's program). The EQT entry must be changed to specify that the device 
is "up" before the user's program can be re-executed. 
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etc 

10 
9 
8 
7 
6 

COLUMNS 5 
4 
3 
2 
I 




1 1 10 9 8 



7 6 5 4 3 2 I |B 14 13 12 
3 2 I 1I5I4I3I2 II 10 9 8 



WMWJWMtoi 



6 5 4 



12 II I 



2 3 4 5 6 7 8 
ROWS 



NOTE.: Column 1 lows LJ-> contain ft 
length octal vaiui: (bits .'■>-' 

CARD LAYOUT 



6 7 8 9|l2 II 0123456789 



2 3 4 5 6 7 8 9|i2 I I 12 3 4 5 



MtfAMWA/Mb* 7 8 9I1211 6T 

15 14 13 12 II IC 9 8 7 6 5 4 3 2 I 



BITS- 



Uur-i i bits 
lunqtn "Cta. 



i 5- y contain record 
iMi ut /rows 1J- 5) . 



USER BUFFER LAYOUT 



e/c. 

8 
7 
6 
5 
4 
3 
2 
I 



MEMORY 
WORDS 



elt. 
10 
9 
8 
7 
6 

COLUMNS 5 
4 
3 
2 
I 





u- C 

O 
O 


D 




1 




tm hihihihi 


Hi Ml 


1 


■■ hi ■ | ■■— i 




■1 | — HI HI 


• *| • • 


HI HI HI HI 




■HO hi hi hi hi 5 4 3 2 1 hi 


• • • «| • 


7 6 5 4 3 2 1 0|I5 — 13 — 


6«8»|»ll««»»45 678« 


3 2 1 0ll5l4— 12 1110 9 8 


2 3 • 5 6 7 8 9|l2 II 1 2 3 4 5 






15 14 13 12—10 9 — 7 6 5 4 


I2M0I»34»678 9|I2II0I 




12 II 1 2 3 45678* 






15 14 13 12 II 10 9 8 7 6 5 4 3 2 10 


SAMPLE CARD DATA 


SAMPLE BUFFER STORAGE Tp 



MEMORY 
WORDS 



TP29030-95001-1 



Figure 2-1. Reading Packed Binary 
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ROW 

12 

11 


1 
2 
3 
4 
5 
6 
7 
8 
9 



(12 EDGE) 



I I I 
I I I 

•|oo|i|i|i||oa 

t I 1 I I I 1 | • H M It li H 
|ll II II I 1 I 1 I II 

2|2|222|222222 
3333|3|3||||11 
44|44444444444 
9SS399S9S5S5SS 

llllllllllllll 

77777777777777 
lllllllllllll! 
99999|99999999 

I I I 4 I I 1 I I * II II II 14 



000 
imn 
I I 1 

222 

313 

444 

55S 

its 

777 
III 



999 

xnn»Kaitmn 



000 

11 u ,. 

1 1 1 

222 
133 
444 
5SS 
IIS 
7 7 7 
III 
99? 



000000 

Hflllll 

iiiiii 


ooooooo 

W 41 47 41 M II ft 
1 1 1 1 1 1 1 


00000000 

1 M 41 H 11 17 I] 14 14 

1 1 1 1 1 1 1 1 


000000 

H 11 M 11 M II 

IIIIII 


0000 

11 U 11 U 1 

1 1 1 1 




1111 

1 


0110 

I It 1 11 17 

1 1 1 1 


ooooooo 

1 it 11 ft li it n K 
111 '! 1 1 


222222 


2222222 


22222222 


222222 




2 


2222 


2222222 


331111 


1331131 


13 3 313 113 


211111 




1 


1131 


1)11111 


444444 


4444444 


144444444 


444444 




4 


4444 


4444444 


5SS5S5 


S5S555S 


55555555 


555SSS 




s 


9 99 9 


99999)1 


tuns 


IllSllt 


IliSSSSS 


ttstss 




1 


till 


lllllll 


7 77 777 


7777777 


77777777 


7777 77 




7 


7777 


7777777 


IIIIII 


•IIIIII 


muni 


IIIIII 




1 


nil 


lllllll 


99 99999999999 

u a » ji M m m «i mi m « it i 


99999999999999 

>4*4IW1IUUM1SH1I1IMM4I 


9999999)9*911191991 

uuMBHiiiiiNtiiiniinniiKiin 



(9 EDGE) 



COLUMNS 1 THROUGH 80 



CARD DATA READ 



ROW ASSIGNED: 



(NONE) 


I2II0I2S4S6 7H9 


(XT TO 01 


ONE 'COLUMN 



ALL BUFFER WORDS 



19 M 13 12 II 10 9 8 7 6 5 4 3 2 I O BITS 

BUFFER WORD ASSIGNMENTS 



CARD 
COLUMN 



3 
4 
5 
b 
7 
8 
9 

10 
etc. 

























BUFFER 
























WORD 


DOO 





■ 


G 


I 


O 

















1st 








o n 


I 





■ 


a 


a 











2nd 








D I 








a o 


I 














3rd 








I 


D 


D 


I 








a 





a 


4th 





n 





I 





O I 











• 





5th 








I 








O 














■ 


6 th 











I 





■ 


a 








a ■ 





7th 








I 


D 





■ 

















8th 








D 


1 





I 











a ■ 


a 


9th 








I 








a ■ 


D 














10th 
etc. 



BUFFER WORDS AFTER DATA TRANSFER 



TP29030-95001-2 



Figure 2-2. Reading Column Binary Image 
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SECTION III 
CONFIGURATION INFORMATION 



3-1. GENERAL 

3-2. This section provides configuration information for Driver DVR11 and is 
intended to augment the data provided in the Real-Time Executive Software System 
Programming and Operating Manual . 

3-3. REAL-TIME GENERATION 



3-4. The driver is loaded into the RTE System during system generation, as 
described in the appropriate RTE Software Manual. At this time, the following 
items must be supplied by the operator to configure the HP 2892A Card Reader 
into the system being generated. 

3-5. PROGRAM INPUT PHASE 

3-6. Driver DVR11 must be loaded during this phase. 

3-7. TABLE GENERATION PHASE 

3-8. In this phase, the following three entries must be made: 

a. An Equipment Table entry for each HP 2892A Card Reader: 
♦EQUIPMENT TABLE ENTRY 

nn,DVRll,D 

where "nn" is the select code of the card reader interface card 

b. A Device Reference Table entry for each HP 2892A Card Reader 
*DEVICE REFERENCE TABLE 



xx = QQT#? 
m 



where xx is a logical unit number. Response "m" is a number that 
corresponds to the "nn,DVRll" position in the Equipment Table 
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c. An Interrupt Table entry for each card reader interface card: 
* INTERRUPT TABLE 



nn 



where "nn" is again the select code of the interface card. 
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